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ABSTRACT 



This thesis contains a survey of the hardware requirements and the 
desirable characteristics of an interactive Computer Graphics System. 
There is a detailed evaluation of the resident system in the Computer 
Laboratory and an attempt is made through programming, to provide a 
software capability which allows for full utilization of all hardware in 
the Computer Graphics System. This program, known as RADIK, is a highly 
interactive graphics and text editor developed for utilization on a 
computer system composed of an XDS 9300 and two Adage AGT-10 graphics 
terminals. In addition, this thesis includes a discussion on the 
development of the system as well as complete operating instructions. 
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I. INTRODUCTION 



Computer graphics is one of the most rapidly expanding developments 
in the field of electronic data processing today. The primary reason for 
this is because, unlike most other computer operations it allows for a 
high degree of interaction between man and machine. The computer pro- 
vides the high speed manipulation of large amounts of data, while the man 
contributes experience, judgment and imagination. Additionally, as 
Licklider [1] accurately stated, "perception is more rapid when a concept 
can be visualized rather than pre-processing alpha-numeric strings before 
we can think about the real concepts." 

A. PURPOSE 

In the design of an interactive system there are many considerations 
to be taken into account and trade offs to be made. Some of these will 
be discussed in this paper along with the evaluation of a particular 
system and recommended changes for improving it. To this end the purpose 
of this thesis is threefold. 

1. To examine the elements and desirable characteristics of any inter- 
active graphics system. 

2. To describe and evaluate the resident graphics system in the 
Computer Laboratory at the Naval Postgraduate School. 

3. Finally, to discuss RADIK, a graphics and text editor program, 
developed in association with Lieutenant R.F. Ashford, Jr., 
which allows for greater interaction with the present system, 
therefore, increasing its capabilities. 

B. ORGANIZATION 

The thesis is divided into 7 parts, exclusive of apendices and 
computer program. 
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Section II is a brief discussion of the historical background of the 
"state of the art" in computer graphics. 

Section III contains a discussion and analysis of the various hard- 
ware characteristics which must be considered in the design of an inter- 
active computer graphics system. 

Section IV is an investigation into the overall, graphical and inter- 
active characteristics which are desirable in any Computer Graphics Sys- 
tem. 

In Section V there is a description of the computer graphics system 
installed in the Computer Laboratory. This description includes a brief 
coverage of the hardware and a detailed description of GATED, the graphics 
and text editor program in use at present. 

Section VI deals with RADIK, a highly interactive graphics and text 
editor program, which has been developed in order to replace GATED. In 
addition, there is a discussion of the objectives of RADIK as well as the 
programming modifications which were made. This section also includes a 
detailed explanation of the procedures required in the operation of the 
program. 

Section VII is devoted to conclusions. 
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II. HISTORICAL BACKGROUND 



A. DEFINITION OF COMPUTER GRAPHICS 

Prior to a description of the early graphics systems, there should 
be an understanding of the term Computer Graphics. The Merriam Webster 
New Collegiate Dictionary (7th ed.) defines graphics as "the art or 
science of drawing a representation of an object upon a two dimensional 
surface according to mathematical rules of projection." Technically 
then, we could extend this definition to "Computer Graphics" by simply 
adding the phrase, for display by a computer. While this would in fact 
be a correct definition it does not convey the true meaning in which 
Computer Graphics are thought of today. In the past few years techno- 
logical developments in computer systems and information handling have 
been directed toward an improved interaction between man and machine. 

This is witnessed by the fact that a great deal of attention has been 
given to improving the languages in which computer instructions are 
written. It may also be evidenced by the fact that a major part of the 
research in Computer Graphics has been conducted in the area of graphics 
languages and interactive systems. This has been done to provide better 
"real time" communications between the computer and the operator. Let us 
then redefine the meaning of Computer Graphics as does Mr. C.I. Johnson 
in his article "Principles of Interactive Systems" [2]. He states, "Com- 
puter Graphics has become an accepted term to denote that set of computer 
techniques and applications wherein data is either presented or accepted 
by a computer in the form of line drawings or graphics." 
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B. PIONEER SYSTEMS 

Having defined the term Computer Graphics a discussion of the early 
systems follows. 

Perhaps the one most significant advancement in hardware design to 
affect the development of Computer Graphics was the time-sharing and 
on-line system. With the advent of these two pieces of equipment it 
wasn't long before pioneers in the Computer Graphics field were devel- 
oping a real time visual display with which individual userscould inter- 
act. 

1 . Whirlwind 

One of the first of these systems to be developed was at MIT in 
the early 1950's. Mr. J. Forrester and a group of colleagues, known as 
the Whirlwind Group [1] developed a graphical display of an air defense 
situation which allowed for user interaction by use of a light gun. 

This light gun was the forerunner of light pens used in today's graphics 
systems and the Whirlwind program was later to become an integral part 
of SAGE [3], an air defense system used in the United States and Canada. 
While the Whirlwind Computer allowed for a very limited amount of inter- 
action, it was at least a start at man machine symbiosis [4], 

2. Sketchpad 

Perhaps the next most significant development was Sutherland's 
SKETCHPAD program [5] in which the use of a CRT display, and a light 
pen to draw pictures, was demonstrated. In this program the computer 
monitored the operator's motions and built a data structure which was 
used to represent the properties of the drawing. In addition, relations 
between elements of the system in the drawing could be specified using 
the light pen, by first selecting the element and then the relation. 
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The major implications of the SKETCHPAD program were that it not only 
allowed the input of data at the CRT, but also made possible the control 
of the program by an external device. This particular program was later 
extended to three dimensions by C. Johnson in SKETCHPAD III [6]. 

3. PAC-1 

In the mid 1960's DAC-1 [7] (Design Augmented by Computer), a 
prototype of the IBM 2250 Graphics System [8] was developed by General 
Motors. The DAC-1 was an experimental system- in which a designer, seated 
at a console, could create or modify the designs of parts of automobiles. 
In addition, these sketches would then become data in the computer's 
memory and with the aid of supporting programs would produce wooden 
models of the sketched parts. 



12 



III. HARDWARE REQUIREMENTS OF AN INTERACTIVE GRAPHICS SYSTEM 



In any interactive graphics system there are certain components which 
are basic to the operation, while others are considered desirable. The 
system must contain at a bare minimum; a digital computer, some means of 
displaying the desired graphical output, and finally, an interface 
through which the user is able to communicate with the computer; a light 
pen, keyboard or similar device. 

A. COMPUTER CONFIGURATION 

One of the most important items in any operation, is the heart of the 
system, the computer itself. In Computer Graphics there are two basic 
configurations which are utilized. The first and most popular, is the 
combination of a small digital computer linked by means of a high speed 
communications system to a large multiprocessing unit. In this type of 
operation the small computer ensures the completion of all graphical 
housekeeping chores, while the host computer has the responsibility for 
programming operations and associated activities. The second, generally 
less desirable, configuration is to utilize one medium size digital 
computer which is dedicated strictly to the graphical problem. 

The relative merits of these two systems will be discussed in a 
later section. 

B. CATHODE RAY TUBE 

1 . Description 

The most widely used display device and the only one discussed 
in this paper is the Cathode Ray Tube. The tube itself consists of a 
phosphorus coated surface on which an illuminated trace is generated by 
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means of an electron gun. The gun fires the electrons at the phosphorus 
covered tube and x/y positioning is obtained electronically by deflecting 
the electrons utilizing magnetic coils. 

2. Visual Parameters to be Considered 

When using the CRT for display purposes there are two parameters 
which should be considered critical to the operation of the tube. Those 
are the decay rate of the phosphor and the refresh rate of the image. 

The decay rate of the phosphor must be fast enough that a 
residual image of an old trace does not become confused with a new trace. 
In order to ensure the above requirement is met and yet keep the image 
on the screen, the refresh rate should be fast enough that a flicker [9] 
free picture is obtained. Normally a refresh rate of 40 times per 
second is sufficient to keep the probability of visual annoyance at a 
low level [10]. 

This presents a case for the use of a "time-shared" system which 
has a large computer capable of handling multiprocessing tasks. While 
the small graphics package is taking care of the refreshing of the 
picture, the large parent computer may proceed with the program being 
executed and process user generated interrupts. 

C. COMMUNICATIONS 

When discussing communications, there are two basic types to be 
considered; man to machine and machine to machine. 

1 . Man to Machine 

For communications with the graphics console, the light pen is 
considered to be one of the most effective methods. The reason being, 
that it not only can be used for the sketching or drawing of figures but 
may also be utilized to control the flow of the program. Other widely 
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used means of communications are by alpha-numeric keyboard, function 
switches, control dials, sketch tablet, joystick and mouse. The joy- 
stick, mouse and variable control dials are analog devices which require 
the presence of a digital to analog converter [11]. 

2. Machine to Machine 

In the case of a shared system (i.e., a graphic console and large 
host computer) there must be a relatively simple high speed interface 
between the two processors. It should be capable of rapidly trans- 
ferring large quantities of information between the two machines. 
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IV. DESIRABLE CHARACTERISTICS OF AN INTERACTIVE 
GRAPHICS SYSTEM 



A. OVERALL CHARACTERISTICS 

1 . Cost Effectiveness and Response Time 

A primary consideration in the selection of an interactive 
graphics system, as with the selection of any expensive computing hard- 
ware, is the cost effectiveness of the system. To this end, the decision 
as to whether to obtain a medium sized computer, which is strictly 
dedicated to graphics or obtain a large time-shared system consisting of 
a small computer linked to a larger one becomes increasingly important. 

When arriving at this decision it must be determined whether a 
strictly graphical system would be utilized enough to be economically 
feasible. In most cases the answer to this question would be no, and a 
system which allows for the host computer to be utilized for "batch- 
processing" when not needed for graphics applications should be chosen. 

In addition, the system should provide rapid response when in the shared 
mode, as a user who thinks nothing of waiting overnight for a "batch- 
job" becomes impatient when having to wait much over 20 seconds for a 
reply when seated at a console [12]. 

2. Simplicity and Effectiveness 

In addition to being cost effective and having a quick response 
time, "two properties of an interactive system which are essential to 
the usefulness of the system, but which compete with each other to some 
extent are effectiveness and simplicity of use" [13]. 

Effectiveness is defined as the ability to solve significant 
problems in a reasonable amount of time and simplicity is merely the 
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quantity and complexity of actions required by the user. It is easy to 
see how these two could be in conflict, as generally speaking the more 
complicated a system is made the more difficult it is to operate. An 
excellent method of testing a system for simplicity of learning is to 
observe the relative ease with which a user is able to operate the 
system. A similar test for simplicity of use is to observe the number 
of actions and the difficulty with which they are carried out. 

B. GRAPHICAL CHARACTERISTICS 

In order for man and machine to work in a close partnership with each 
other, the computer should have the capability to accept, interpret and 
remember not only shapes, but any descriptive information which might 
be introduced graphically [14]. 

1 . Draw/Sketch Capability 

To fulfill the aforementioned requirement the user should be 
able to introduce geometrical figures into the machine by specifying the 
points to be connected and then invoking a draw command to connect the 
points or by selecting a sketch function, allowing the user to draw the 
figure with one continuous line. This would be done by a light pen or 
other similar input device. 

2. Editing Capabilities 

Routines which modify the geometrical representation of the 
figure, such as scaling up or down, or changing the display from a 
dashed picture to solid, as well as routines to rotate or translate the 
figure in order to obtain different views .are especially useful. In 
addition, a set of functions available to produce the more common 
geometrical shapes such as circle or square saves much programmer time 
and effort. 
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3. Speed 



One of the main advantages in using a digital computer is the 
high speed obtained in making routine calculations. Speed should also 
be a factor in our graphics system. However, a highly interactive 
graphics system will not only do calculations rapidly, but will also 
allow the user to view immediately any modifications which are made to 
the display. 

4. Miscellaneous 

While most of the graphical applications mentioned to this 
point may adequately be displayed on a two dimensional system, a console 
which has the added feature of a three dimensional display is advan- 
tageous. This is especially true in systems utilized for any type of 
design applications. 

Finally, in any graphics system be it of the stand alone 
variety or one which is linked to a large multiprocessing unit, storage 
space is likely to be at a premium. One, and perhaps the most efficient 
means of helping to minimize this problem is to have library callable 
subroutines. These could then be called in from secondary storage as 
required to perform routine operations. By using this method, only the 
operating system and the program concurrently running need be in main 
storage, saving space, while allowing the user to work with larger and 
more complex programs. 

While these are by no means the only graphical characteristics 
which are considered desirable they are the most important and a 
majority of them should be included in any up-to-date well organized 
system. 
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C. INTERACTIVE CHARACTERISTICS 

Whenever a graphics application program is written it should be 
remembered that individuals other than those familiar with programming 
may have access to the system. This being the case then, the system 
should be capable of allowing the program to explain itself to the user 
in words, as well as with pictorial representations. It should guide 
the user through the program, step by step, presenting the results at 
each decision point as well as presenting the appropriate options to be 
taken from that point. It should also allow decisions to be deferred 
by storing results from various inputs until ready to make final 
comparisons. 

1 . Communications 

There are many characteristics which must be designed into a 
system in order to make the graphical options possible. The one single 
characteristic upon which all others are dependent is the ease and 
flexibility with which the user is able to communicate with the system. 

There should be a relatively simple interface between the user 
and the console, allowing for rapid and effective transferral of infor- 
mation between the two. As stated earlier a light pen makes an excell- 
ent means of communications with a graphics system. The reason being 
that the light pen may serve a dual purpose. It not only can be used 
to draw or sketch figures as is normally done, but it may also be 
utilized to control the flow of the program by using the device as a 
"pick" and making a selection from a menu. In this manner the user has 
the ability to tell the program where to go and what to do as desired. 
Thereby, providing greater versatility in programming. Additionally, 
some means of textual input, such as an alpha-numeric keyboard, should 



19 



V. 



be an inherent part of the system. Another item which comes under 
consideration in discussing communications and is considered critical 
to the system, is the language selected for implementation on the 
machine. A purely graphical language such as POGO [15] or GSP [16] 
is the most desirable as it allows the user to communicate with the 
machine in terms that are more meaningful to graphics application. 
However, any higher level language, such as Fortran IV, which may be 
adaptable to the system is considered acceptable. 

2. Error Recovery 

A system which allows for the fact that errors are going to be 
made and provides for quick and nondestructive error recovery procedures 
will provide for easier and more complete interaction by the user. 

3. Data Structures 

The primary requirement of a graphics data structure is to link 
names (memory addresses) with images and sub-images. In order to con- 
tribute to the interactivity of the system the data structure should be 
capable of performing the following actions; the addition of new or the 
deletion of old information, to search, sort or duplicate the informa- 
tion stored in the system and finally, it should allow for the re- 
sequencing of the data structure and reallocation of memory once these 
actions have been performed. (This procedure is commonly referred to 
as garbage collection). 

There are three basic types of data structures used in computers 
today [17]; the sequential, random and list. 

a. Sequential Structure 

The sequential structure is the simplest and is merely the 
storing of records [17] sequentially in memory according to a common 
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attribute. This has the advantage of allowing records to be retrieved 
quickly while having the disadvantage of being slow to insert a new or 
delete an old record because the whole file must be updated whenever a 
change occurs. 

b. Random Structure 

A random data structure utilizes a bookkeeping procedure 
which assigns an arbitrary address to a piece of data when it is 
received and all references made to the entry are by that address 
thenceforth. Other means of using a random data structure are by hash- 
coding [18] and Table lookup [18]. 

In hashcoding the name itself is treated as a number and 
standard calculations are performed on it giving an address. In the 
table lookup method, the most popular random method, a table of names 
and addresses is set up and each time a reference to a particular 
block is made, the address is looked up in the table. 

c. List Structure 

The main characteristic of a list structure is that the 
records are chained together by a series of pointers. A pointer being 
simply a word in memory which contains an address of a word or series 
of words in memory. There are many different kinds of list structures; 
linear, circular, doubly linked and orthogonal [19], to mention only 
the most familiar. The most commonly used of these is a circular list 
called a ring structure. A ring structure is one that has the last 
address being a pointer to the head of the list. The advantage of a 
ring structure is that it is very easy to work with. To enter a new 
element, all that is required is to put the element in memory and have 
a bookkeeping procedure which ensures the connection of the forward 



21 



and backwards pointers. For deletion of an element the reverse pro- 
cedure is followed. 

The utilization of most any of the data structures discussed 
would be satisfactory for an interactive graphics system. However, the 
most efficient is one which utilizes a combination of two types, using 
one for the drawing functions and another for operating on the completed 
drawings [20]. 
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V. PRESENT SYSTEM 



A. HARDWARE DESCRIPTION 

The Computer Laboratory's graphical display system is composed of 
four main pieces of hardware; a general purpose digital computer (the 
XDS 9300), an analog computer, the Ci 5000 (not a topic of discussion in 
this study), and two small graphics computers produced by the ADAGE Cor- 
poration. (Hereafter referred to as either ADAGE or AGT/10). The hard- 
ware configuration along with the various communications paths are 
shown in Figure 1. 

1. XDS 9300 

The XDS 9300 [21] may be utilized by itself to process XDS 
Fortran jobs or it may be used as the host computer for the graphics 
consoles. It has a 24 bit word, 32K words of main storage and a magnetic 
drum that may be used for secondary storage. Control of the 9300 is by 
commands issued at the operator's console or by inputs to the tele- 
typewriter, card reader, paper tape reader, line printer and two magnetic 
tape drivers. Due to the fact that the 9300 has an interrupt driven 
real time capability, a sophisticated CPU capable of handling a large 
instruction set, and the added capability of referencing a large 
secondary storage device, it is especially useful in graphical appli- 
cations. 

2. A dage AGT/10 

The two Adage AGT/10 's may be operated independently, in the 
stand alone mode, or in conjunction with the XDS 9300 host computer. 

The Adage graphics terminals are display stations consisting of the DPR 
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2 digital processor, a vector generator and a character generator [ 22 ]. 

The DPR 2 is a general purpose digital computer having a 30 bit 
word, 8 K of primary storage, and a magnetic disk pack available for 
secondary storage. Interactive devices supplied with the system 
include: a light pen, 16 function switches, two foot pedals, a joy- 

stick, 6 variable control dials and an alpha-numeric keyboard. The 
only other peripheral device is a paper tape reader/punch. 

The character generator is a high speed stroke writer [22] with 
a 64 character vocabulary, expandable to 96 characters. The characters 
can be displayed in one of three sizes at one of three intensities and 
either upright or italicized. 

3. XDS 9300/AGT/l 0 Interface 

The communications between the AGT/10 and XDS 9300 is 
conducted through a sophisticated interface system [23]. The interface 
provides for a 24 bit data path which transfers information at a rate 
of 250 KHZ to the 9300 while allowing for a transfer rate of 160 KHZ 
from the 9300. Only 24 bits are transferred because this is the size 
of the computer word in the 9300. In transferring information it 
should be remembered that the first 6 bits of the AGT/10 word will be 
lost, therefore a shifting operation, is normally done on this word to 
obtain the proper degree of significance, prior to sending the infor- 
mation to the 9300. Conversely, when information coming into the AGT/ 
10 has been received it is usually shifted in the opposite direction 
to fill up the first six bits. 

The data transfer is half duplex [23] and is always initiated 
by an AGT program. Transfer can occur between any AGT core location 
and any XDS location in excess of 20 OO 3 , the maximum length of a block 
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transferred is 8K, core size of the AGT/10 



B. GATED 

1 . Description 



GATED is a graphics and text editor program written in ADEPT, 
the AGT/10 assembly language, and is loaded from disk into main memory, 
by the system monitor, upon command. It may be used in the stand alone 
mode to draw or sketch pictures, but it is required whenever the Adage 
is used as a terminal in conjunction with the XDS 9300. 

The purpose of GATED is threefold: 

1. It is the means of communication (i.e., the interface) between 
the graphics console and the operator. It has the capability 
in the stand alone mode of accepting graphical input from the 
light pen, joystick, foot pedals, variable control dials and 
function switches, while obtaining textual inputs from the 
keyboard. When used in conjunction with the 9300 the light pen 
is the primary interface for graphics, while again the key- 
board is used for text editing. By utilizing these devices 
properly, data may either be created or existing data may be 
edited. 

2. The second purpose GATED serves is to communicate with the 
Fortran callable graphics programs and subroutines which 
the user may store in the XDS 9300. Through the interface 
discussed earlier the Fortran program may create and edit 
data displayed on the AGT/10 CRT. 

3. Finally, in addition to the normal editing operations 
carried on by GATED, the display screen is refreshed con- 
stantly at 40 frames per second. It is noted that re- 
freshing of the picture discontinues during data transfers 
by the interface between the AGT/10 and the XDS 9300. 

2. Data Structure 



GATED allocates storage for graphics and text data individually. 
It further divides each into blocks [21] and utilizes separate book- 
keeping procedures to keep the two from being confused. 

Text data is stored as alpha-numeric strings each block con- 
sisting of 26 words in memory. The first two words contain control 
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information and the remaining 24 words are filled with 4 characters 
per word. This gives a block length of 96 characters, allowing for 
one text line per block which is equivalent to one line on the display 
screen. This allows for a maximum of 40 text lines to be displayed. 

It is noted that when transmitting text from the 9300, it may only be 
sent one block (i.e., one line) at a time, and then it must be 
specified by line number and character position. 

Graphical displays are represented as a series of straight 
lines. Each graphics block consists of one word of control information 
followed by the number of data words required to draw the picture, 
stored sequentially in memory. The first word of a graphics block 
consists of 14 empty bits followed by 1 bit which determines whether 
the figure being drawn will.be dashed or solid. The last 15 bits are 
used to specify the intensity of the picture, the last bit of which 
is always zero. 
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DASH/SOLID 

Figure 2 

(AGT/10 Graphics Control Word) 

The second and succeeding data words contain the x, y, car- 
tesian co-ordinates for the data point that the word represents, as 
well as a bit which determines whether the point is a move or a draw, 
and finally a bit which indicates end of vector. The end of vector bit 
is always a zero except for the last word which is a one, indicating 
to the vector generator that it is finished drawing. 
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Handler 




Move/Draw 





Figure 3 

(AGT/10 Graphics Data Word) 

There is a simple garbage collection routine used by GATED to 
keep the graphics block compact, thereby conserving storage space. 

This routine is called SHRNK and is invoked anytime a graphics block is 
created at the AGT/10 or sent over from the 9300. Whenever a block is 
selected, SHRNK searches it to ensure there are not two or more data 
words which contain moves stored sequentially in memory. If in fact 
there are two or more in a row the SHRNK routine eliminates all but 
the last and shrinks the block in such a manner that it still resides 
in sequential memory locations. The space from which the words have 
been deleted are then returned to memory for reallocation. 

3. Operation 
a. General 

Once GATED has been loaded into memory from the secondary 
disk storage and executed by typing GATED!, C/R (where C/R stands for 
carriage return), or GATED(l)!, C/R, depending on whether the AGT/10 
is being used with the 9300 or in the stand alone mode, the user has a 
number of options available. 

By utilizing the light pen, function switches and tele- 
typewriter the operator has the capability of creating or editing both 
text and graphics blocks as desired. 

The function switches provide for the master control of 
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GATED. As seen in Figure 4 they allow for the selection of the desired 
mode of operation as well as making available a limited number of 
editing functions such as: erase, move, draw, and track-end point 

operation. 



In the track-end point mode the end point of a vector, or 
the intersection of two vectors may be selected by the use of the light 
pen. This point will then become attached to the cursor which is 
displayed and follow the light pen as long as the track-end point 
function switch is depressed. 

b. Graphics Editing Procedure 

In order to draw a picture on the display tube, the light 
pen must first be turned on and the following sequence of operations 
carried out. 

1. Depress function switch 2 in order to put GATED in the GRAPHICS 
SELECT mode. 

2. By utilizing function switches 5, 6 and 7 (see overlay Figure 4 
for specific function of each switch) the graphics block which 
is to be edited may be selected. 

3. Depress the GO EDIT button, function switch 8. This now puts 
the system into the GRAPHICS EDIT mode. The creation of the 
new data may be thought of as editing a new block. 

4. At this point the cursor may be turned on, by depressing 
function switch 9, and the block edited by use of the light 
pen. 

5. While editing the display, function switches 13, 14, 15, 
and 16 may be utilized, giving the capabilities of move, 
draw, sketch and erase respectively. 

6. By depressing END-EDIT, function switch 4, control is 
returned to the 9300 if in that mode of operation or to 
GATED itself if operating stand alone. In addition, the 
garbage collecting routine, SHRNK, is called and the unused 
portion of memory is returned to the machine for further 
allocation. This is made necessary by the fact that if a 
new block is selected, the entire remaining AGT/10 core is 
made available to the operator. 
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c. Text Editing Procedure 

Text edit procedures are similar to those of the graphics 
edit mode. Once in the text edit mode and a block is selected, a 
cursor will appear on the screen and may be positioned as desired by 
the teletypewri ter. By utilizing the alpha-numeric keyboard, desired 
text input is made. The size or position of the text may be further 
modified by using function switches 9, 10, 12, 13, 14, 15, and 16 
(see Figure 4 for specific operations). By depressing one of the 
switches, marked increase or decrease (x or y), the position of the 
text will be moved one line or one character position at a time. To 
move the text more than one position at a time the desired function 
switch may be depressed repeatedly or the same effect may be obtained 
by depressing the desired function switch and REPEAT simultaneously. 
Pressing the END EDIT switch causes control to return in the same 
manner as discussed under the graphics edit operation. 

d. Fortran Operations 

To support the Fortran operations performed by the XDS 
9300 there are a number of library callable subroutines which are re- 
quired for the smooth operation and interface of the two machines. 
These will be covered in the discussion of RADIK as many had to be 
changed to obtain the desired results. 

C. SYSTEM EVALUATION 

The resident computer graphics system in the Computer Laboratory 
is adequate for most applications and demands which are placed on it. 
However, there are limitations in the present configuration and 
improvements to be made. This section is an attempt to objectively 
identify and discuss these limitations. 
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Because GATED is the primary interface between the operator and 
the graphics console the greatest amount of attention was focused in 
this area. However, a cursory look was made into the present hard- 
ware set up and a few deficiencies were noted. 

1 . Hardware Limitations 

At this time the Adage graphics terminals are capable of 
communicating with the S30C in series, i.e., one at a time. While 
this is not considered a serious restriction on the system, the fact 
that only one terminal at a time may utilize the XDS 9300 to host a 
Fortran program is considered unsatisfactory. 

There is much computer time lost due to the fact that an AGT 
remains idle merely because the present system only allows one Adage 
to be interfaced with the 9300. With the multitasking and multi- 
programming capability possessed by the 9300 there should be a means by 
which both terminals access the 9300 simultaneously, through a system 
of priority interrupts similar to an actual time-sharing system. This 
would in fact make the system more cost effective through reduction of 
dead time. 

While not completely a hardware problem another deficiency 
which exists is the difficulty that arises when trying to display text. 
This is especially true when operating stand alone, utilizing some 
program other than GATED. At present it is extremely difficult to input 
or edit a textual display, produced in conjunction with a figure. Part 
of the problem lies in the character generator and the refreshing of 
the picture, while the other is the manner in which the character 
generator is invoked. By upgrading the text facilities of the system, 
a greater versatility in programming could be achieved. 
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2. GATED Limitations 



The program GATED is a simple and effective interface between 
the operator and the machine. While it adequately handles the tasks 
which have been programmed into it, there have been omissions which 
limit the systems capabilities, whether in the stand alone mode or in 
operations with the 9300. The majority of these limitations may be 
eliminated through programming expertise as the hardware capability is 
already present in the equipment at hand. 

a. Flexibility of Communications 

The first of these programming oversights for which there 
is hardware readily available is flexibility of communications. GATED 
is controlled by the function switches and accepts inputs from the 
light pen and teletypewriter. However, this still leaves two unused 
sources of communications, the joystick and variable control dials. 

b. Control of XDS 9300 

By proper programming the increased flexibility of 
communications could help to overcome the fact that an operator has 
very little control over the XDS 9300 when at the graphics console. 

At this time the only control, which the user is able to exert over 
the flow of a Fortran program, resident in the 9300, is pushing the 
END EDIT function switch which causes the program to return to the 
point of the edit call and continue execution. This is a severe 
limitation and causes much consternation on the part of the user. 

c. Graphics Editing Functions 

While the hardware will allow it, at present, the system 
has no built-in editing functions which gives the user the capability 
of scaling or moving the display about the scope in order to obtain a 
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different perspective of the figure. In addition, there are no built- 
in functions which allow for the drawing of common geometrical figures 
such as circles or squares and it is a waste of the operator's time 
to have to construct these each time one of the figures is desired. 

d. Text Editing Functions 

An option similar to the one discussed in the previous 
paragraph is considered desirable in the text edit mode also. Even 
though the routines are available which allow for the moving of text 
data around the screen, there is no capability for transmitting the 
new position back to the XDS 9300. This is because the bookkeeping 
procedure utilized in keeping track of the text blocks by the AGT and 
9300 are different. The AGT keeps track of blocks only and the 9300 
attaches a line number and character position to each block of text 
and it is referenced in this manner. 

3. Fortran Limitations 

In addition to the limitations placed on the system by GATED 
there are some changes which could be implemented on the 9300 "side 
of the house" that would enhance the versatility and efficiency of 
the system. 

a. Data Transfer Inefficiency 

The first of these would be to change the procedure by 
which graphics blocks are sent to the 9300 from the AGT. Now, the 
size of the block sent back to reside in the 9300 core is strictly 
dependent on the value to which the block was dimensioned in the 
initialization steps of the Fortran program. This occurs independent 
of the number of words required by the AGT. It would be much more 
efficient to have the AGT return only the number of words required 
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for the display and invoke a garbage collection routine similar to 
the SHRNK routine available to GATED for the return of core for re- 
allocation. 

Another problem similar to this is the fact that all 
graphics blocks must be transmitted from the 9300 sequentially starting 
with number one. It would be much more convenient if there was an 
option which allowed for the block to be referenced by name or in any 
numerical order, designated by the operator.' 

There are, to be sure, other items which contribute to 
the ineffectiveness and impose limitations on the system. However, 
these are considered to be of major importance and will be discussed 
in greater detail in the section on RADIK. 
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VI. RADIK 



A. GENERAL DESCRIPTION AND PURPOSE 

RADIK is a graphics and text editor program developed in association 
with Lieutenant R.F. Ashford, Jr. for implementation on the AGT/10, Adage 
graphics terminal. It is written in ADEPT, the AGT/10 assembly language, 
and is a direct descendent of GATED; the graphics and text editor in use 
at this time. 

RADIK was developed in an attempt to overcome the previously 
discussed limitations of the graphics and text editor program presently 
used in the computer graphics system. By the very nature of the work 
required for the accomplishment of this task, the problem had two easily 
definable areas of responsibility. The first, which came under the 
cognizance of Lieutenant Ashford, was the development and implementation 
of routines for the AGT/10 graphics terminal. In order for these to 
function properly and with any degree of sophistication the supporting 
subroutines for the XDS 9300 graphics package had to be developed. This 
aspect of the project came under the responsibility of the author. 

Throughout the development of RADIK a high degree of interaction 
and a free interchange of ideas were required to ensure the successful 
completion of the project. In many areas, as in the change required to 
the data structure, the work overlapped and the highest degree of 
coordination of effort was required in order to obtain the desired 
results. 

RADIK, the final outcome of this joint effort, has the following 
purposes: 
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1. Act as a highly interactive interface between the user and 
AGT/10 graphics terminal, allowing for full utilization of 
all peripheral hardware. 

2. To serve as a method of controlling and communicating with 
the Fortran callable graphics programs and subroutines 
resident in the XDS S300. 

3. To not only refresh the picture as done by GATED, but to 
also provide additional editing capabilities to supple- 
ment the routines presently available. By utilizing the 
function switches in the edit mode, the following 
operations may be performed on the display: 

a. Translation in the x and y planes, 

b. Scale up or down, and 

c. Rotation of the display. 



B. DEFINITION OF THE PROBLEM 

The ultimate goal in the development of RADIK was to produce a 
highly interactive graphics and text editor program which not only 
possessed all of the capabilities of its predecessor, GATED, but 
would accomplish the following objectives as well: 

1. Provide for the inclusion of scale factor as an argument 
to the Fortran callable subroutines utilized for graphical 
appl ications. 

2. Provide for the inclusion of DX and DY as arguments to the 
Fortran callable subroutines utilized for graphical 

appl ications. 

3. Development of an additional graphics subroutine which 
would allow combinations of scale factor, intensity, DX, 

DY, and dashed/solid information without sending the x/y 
data list. 

4. To provide editing routines which allow for the rotation, 
translation and scaling cf a display by utilizing the 
function switches. 

5. Allow for specification of graphics blocks by name or 
number, without being restricted to transmitting them in 
sequence. 

6. To provide for the sampling of function switches, joystick 
and variable control dials by Fortran callable subroutines. 



37 



7. Elimination of the problem whereby GATED is "locked" into 
the edit mode, (i.e., no control over the program from the 
graphics console). 

8. Make the graphics Fortran package more efficient by modi- 
fying it in such a manner, so as to store the "current 
length" of graphics blocks returned from the AGT/10. 

9. Allow for the return of text to the 9300 which has had its 
position modified at the AGT/10. 

C. PROCEDURE FOLLOWED 

In the development of each of these objectives there were two main 
requirements to be met. First, the affected areas in GATED had to be 
found and the ADEPT coding modified. Secondly, the Fortran callable 
subroutines required for the support of graphics programs in the 9300 
had to be modified or in some instances new ones introduced. These 
were written either in meta- symbol , the 9300 assembly language or 
Fortran. 

1 . Translation and Scale Factor 

In attacking the problem the decision was made to first 
construct a new data structure and use this for the basis on which to 
build the other changes. Because the first three objectives were 
closely related to the data structure problem, they were attempted 
simultaneously. 

a. Additions to RADIK 

(1) Data Structure . The data structure of RADIK is 
similar to that of GATED in that storage is still allocated separately 
for graphics and text data. 

Furthermore, graphical displays continue to be 
represented as a series of straight lines. However, the internal 
representation has changed somewhat. The first control word of a 
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graphics block consists of 14 bits allocated to scale factor, followed 
by 1 bit which advises the machine whether to display the image as a 
solid or dashed line. The first 15 bits contain the DX value and the 
last 15 bits the DY value. The 15th and 30th bits are always zero 
because they are the end of vector and move/draw bits respectively. 

If they were not zeroed out, the vector generator would consider itself 
finished drawing the figure after the second word and if the draw bit 
was on, a line would be drawn from the center of the scope to the 
point DX, DY which would be unsatisfactory. 

The combined structure of the first two control words 
is as shown in figure 5. 
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Figure 5 

(First two control words of a graphics block) 

The remaining data words are set up in the same type structure as is 
found in GATED. 

2. Other Changes . Due to the fact that GATED already had 
the proper equations available 
X' = DX + Sc ( X ) 

Y' = DY + Sc(Y) 

Where: X' is the new value of X. 

Y* is the new value of Y. 

DX is the value of the X displacement. 
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DY is the value of the Y displacement. 

Sc is the value of the scale factor. 

The other major additions to RADIK were in reshuffling the many 
pointers to the graphics blocks to ensure the control words were 
accessed in the proper manner and the changing of the SHRNK routine. 

SHRNK, the garbage collecting routine previously 
accessed by GATED required modification in order to accept the first 

two, and possibly even the third word as a move. Prior to changing 

SHRNK, the routine was eliminating the first word, using the second 
word and using the first data point (3rd word) as DX and DY. This 
resulted in the distortion of the display, 
b. Fortran Routine Required 

In order to operate with RADIK's new data structure there 
had to be a change in the method in which the words were constructed 
in the 9300 for transmittal to the AGT/10. Formerly this was accom- 
plished by invoking the on-line function IHEAD [22], which through a 
series of shifting and masking operations would place the calling 
arguments; dash/solid and intensity, into the proper format as shown 
in figure 2. A new function, IPAKM (see appendix for listing), which 
includes scale factor as a calling argument was developed. In the 
routine, IPAKM is given the value of IHEAD (dash/solid, intensity) 
logical OR'ed with scale factor. This results in the control word of 
figure 5 (page 39). 

In addition, a new subroutine UNPAKM, to unpack the first 
control word when transmitting edited data from the 9300, was required. 
The routine is called with the first control word and the variable 
names for intensity, dash/solid and scale factor. In the routine a 
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series of ANDing operations occur which stores the proper values into 
intensity, dash/solid and scale factor for storage in the 9300. 

c. Applications and Limitations 

By utilizing these routines it is no longer necessary to 
transmit the X/Y data list in order to translate or scale the figure, 
as was previously required. It is only necessary to pass the first 
two control words, once the X/Y data list has been stored in the AGT/ 

10. Additionally, this gives the capability of being able to pass the 
parameters for translation and scale factor at the time of a subroutine 
call to output a graphical display from the 9300. 

When utilizing these routines, DX and DY may take on any 
value between +1.0 and -1.0, while scale factor may range from 0, a 
point, to 3776g. The limitation of 3776 q is placed on scale factor 
because there are only 12 bits allocated for this parameter and if any 
number larger than a 3 was utilized in the first digit it would result 
in the first bit being a 1 and the scale factor would be negative, which 
is undefined. Additionally, with the restriction that the last bit 
be a 0, because of the end of list vector, a number which ensures the 
last bit is a 0 (0, 2, 4, 5, or 6) must be utilized in the last digit. 

It is noted that some capability of the AGT/10 is lost as it will 
handle a scale factor of 37777 q which is limited by the length of the 
line the character generator is capable of producing. 

d. Operation 

In order to invoke the routine described, the normal 
graphics editing routines are utilized, substituting IPAKM for IHEAD 
and UNPAKM for UNPACK on the first data word only. A typical call to 
IPAKM would be as shown on the following page: 
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IMAGE (1) = IPAKM (0, 10, scale) 

Where; 

IMAGE (1) is the first control word of the display. 

0 is the dash/solid parameter, in this case a solid figure will 
be drawn. 

10 is the intensity at which the figure is to be displayed. 

Scale is the variable to which the desired scale factor is 
assigned; 

A typical call to UNPAKM would be: 

CALL UNPAKM( FRAME (1 ) , INT, IDSH, SCALE) 

Where; 

FRAME (1) is the same as IMAGE (1 ) . 

INT is the variable name in which intensity is stored. 

IDSH is the variable name in which dash/solid information is 
stored. 

SCALE is the variable name in which the scale factor is stored. 

2. Editing Routines 

The next problem attacked was the development of routines, in 
RADIK, to allow for the translation, rotation and scaling of a figure 
while seated at the graphics console with the system in the GRAPHICS 
EDIT mode. 

a. Additions to RADIK 

To obtain the desired result it was necessary to add seven 
additional sets of code to allow for: translation; up, down, left and 

right, scale; up or down and counter clockwise rotation. The code 
which was developed is shown in the Computer Program. In addition it 
was necessary to insert coding which would allow for function switches 
1, 2, 3, 5, 6, 7, and 8 to be utilized, by the applications program 
after the GO EDIT function switch has been depressed. 
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b. Fortran Routines Required 

It was not necessary to introduce any new Fortran pro- 
cedures in order to make these operations possible as the Fortran 
routines normally utilized for graphical operations are quite adequate 
in this case. 

c. Applications and Limitations 

It is considered advantageous for a user to be able to 
translate, rotate and change the size of a picture while seated at 
the graphics console. By having this capability the user may transmit 
a rough figure from the 9300 and by entering the GRAPHICS EDIT mode 
fine tune the display. Additionally, this provides the ability to 
obtain different views of a display. 

There are two limitations built into these routines 
neither of which is considered a serious detriment to the system. The 
first of these is that if a figure is input from the 9300, or from the 
graphics console the first data point must not be a move. If a move is 
generated and eventually rotation is desired the display will become 
distorted while rotating. This may be avoided and the desired results 
obtained by merely slowing the cursor to the desired point of the move 
and start drawing from there. The other limitation is that the figure 
may not be rotated for an excessive number of revolutions as the 
picture will become smaller. The reason for this is because of the 
manner in which the arithmetic is done on the array containing the 
data points. In order to prevent this it would be necessary to have 
a dummy array of some standard length saved aside to store the data 
list in, while the numerical operations are performed. It is not 
considered that the effort required to accomplish this justifies the 
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results which would be obtained, especially since the scale factor 
routine may be utilized to obtain the proper size picture, 
d. Operation 

In order to operate these functions it is necessary to 
depress the GO EDIT function switch (number 8) once the desired 
graphics block has been obtained. At this time function switches 1, 

2, 3, 5, 6, 7, and 8 are freed from their normal duties and given the 
capabilities as shown in the RADIK overlay. Figure 6. The function 
switches remain available until the END EDIT function switch (number 
4) is depressed. 

3. Sampling of Function Switches, Joystick, and Variable Control 
Dials 

By devising a method by which the function switches, joy- 
stick and variable control dials may be sampled, on command from a 
Fortran program the flexibility of communications with the system is 
again improved. 

a. Additions to RADIK 

In order to allow for the utilization of the previously 
mentioned hardware it was necessary to program RADIK to first recog- 
nize a new special command, for each individual piece of hardware 
which could be accessed from the 9300. This in turn causes RADIK to 
make an external call on TRJSB [24] and TRVCD [25] in order to obtain 
the present values of the joystick and variable control dials 
respectively. In addition it was necessary to include code which 
would send an interrupt to the 9300 to allow for the data to be trans- 
mitted, and then signal completion of the action. It was relatively 
easy to obtain the values of the function switches as this information 
was already being stored by RADIK in the normal course of events. 
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Function Switches 
(RADIK Overlay Shown) 
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Once the values were obtained they could be transmitted to the 9300 in 
the same manner as for the joystick and variable control dials. 

b. Fortran Routines Required 

For each piece of hardware a metasymbol routine was 
developed for inclusion into the library package of subroutines. 

The purpose of each of these routines, VCD, JOYSTK, and 
SWITCH is to signal the AGT/10 to sample the desired piece of hardware 
and transmit the address to which the desired information is to be 
returned for storage in the 9300. 

The values returned by VCD and JOYSTK are signed fractional 
numbers which are extremely awkward to operate with. Therefore, it was 
necessary to develop the metasymbol routine XFORM, which converts the 
signed fractional values into a real number. This results in a normal 
decimal value on which it is easy to perform all arithmetic operations. 
This routine is hidden from the programmer as it is called from within 
VCD and JOYSTK. A flow chart and listing may be found for each of 
these three routines as well as for SWITCH in Appendix B. 

In order to determine which of the function switches were 
being depressed, a Fortran logical function was developed. The function 
is called CHANGE and requires the switch number to be tested and address 
in which the switches are stored to be passed as calling arguments to 
the function. Through a shifting and masking operation the function 
determines whether or not the switch to be tested is on or not. If it 
is on a value of TRUE is returned to the call, otherwise it remains 
FALSE. The routine is listed in Appendix A. 

c. Applications and Limitations 

By proper utilization of the routines VCD, JOYSTK, and 
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SWITCH the user has an excellent method of controlling the flow of a 
Fortran program, from the graphics console. This adds a much needed 
capability and upgrades the system by allowing for greater user inter- 
action. One use to which this could be applied would be in the de- 
bugging phase of a programs development. The operator could have the 
program execute up to a desired point and then display the required 
figure. The program could be held in a loop in which one of these 
routines is invoked and when the desired value is set by the operator 
at the graphics console the program could be returned to start over, 
continue execution, terminate or jump to any desired instruction as 
specified by the programmer. As can be seen this also eliminates the 
problem whereby the user is "locked" into the EDIT mode at the AGT/10. 

There are of course many other applications for which these 
routines may be utilized, limited only by the imagination of the user. 

There are no known limitations or restrictions on the 
usage of these routines, 
d. Operation 

A complete description of VCD, JOYSTK, SWITCH and XFORM 
including examples of how and for what they may utilized may be found 
in Appendix B. 

The logical routine CHANGE, which allows for the testing of 
the function switches, may be utilized anytime after the call to SWITCH 
has been made, preferably immediately thereafter. The call to the 
routine is made by using the form IF(CHANGE(3, ISWITCH) ) XXX 
Where; 

The 3 is the number of the switch to be tested. 

ISWITCH is the address that the switches are stored in. 

(This must always be an integer variable) 
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XXX is any executable Fortran statement. 

The executable Fortran statement will be executed in the event the 
routine returns a value of true. Otherwise, the next executable state- 
ment below the IF CHANGE statement will be executed. 

D. DISCUSSION OF RESULTS AND EXTENSIONS TO THE PROGRAM 

As initially stated there were nine objectives, at which an attempt 
was made, in the development of RADIK. Of these, six were completed 
and have already been discussed, one was considered unfeasible and two 
are in the planning stage. 

For the objectives which have been met, all Fortran routines and 
ADEPT coding is working properly and there are no known limitations 
other than those already discussed. The one objective abandoned as 
unfeasible was the one concerning the ability to send graphics blocks 
to the AGT/10 other than sequentially starting with the number 1. It 
was found in order to keep from confusing the user that it would be 
necessary to modify the manner in which the block numbers are displayed 
on the graphics terminal and in order to do this it would require more 
time than the results would justify. In addition, this is not con- 
sidered to be that serious of a restriction. 

The remaining two not completed are the ability to transmit to the 
9300 only the graphics block length required and the ability to send 
text blocks back to the 9300 for storage after the position has been 
modified at the graphics terminal. It is recommended that they be 
included as items to be completed in future work. In addition to these 
two it would be desirable to have the capability of being able to 
produce some of the more frequently used geometrical shapes such as a 
square or a circle. This could be accomplished by utilizing one of the 
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footpedals as a toggle to free the function switches from their 
present tasks. They could then be utilized for this application. 

One note of caution, any changes which are made should be done so 
only after a close inspection of the amount of core which would be 
required for the operation has been made. The reason for this is that 
the original GATED allowed for 3100 words (as shown in figure 7) of 
working storage and RADIK has reduced that by 400 words. Therefore, a 
problem could exist in future modifications in that there would not be 
enough working storage available to utilize the system properly. 
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VII. CONCLUSIONS 



In the initial discussion of the desirable characteristics of an 
interactive graphics system it was found that interaction, that is, the 
ability to communicate with the system was the basic building block on 
which an effective and efficient computer graphics system was con- 
structed. To this end, the theme throughout RADIK is to provide for a 
high degree of interaction by improving the lines of communications 
between the operator and the machine. 

It was stated earlier that a language devoted strictly to the prob- 
lem of computer graphics was the ideal approach to the programming of 
a system. While this in fact may be true, it has been shown in this 
study that a close approximation to the effectiveness gained in this 
manner may be approached by the proper interfacing of the equipment 
available, through a highly interactive operation system. 

As a direct result of the programming effort expended in the pro- 
duction of RADIK, the computer graphics system in the Computer Laboratory 
has been upgraded to allow for a greater degree of user interaction. 

Due to this increased effectiveness the user has available the ability 
to better utilize the Fortran graphics package and the graphics terminal 
including associated peripheral hardware. 
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APPENDIX A 



FUNCTION I p A<M( IOS w / INT/SCALE) 

I pA«M = L I OR ( I ME AD ( IDSH, I NT)* SCALE) 

100 return 

END 



SUBROUTINE UNPAKM( IMAGE (1)/ iNTi IDSH/ SCALE) 
INTEGER TE M P 
INTEGER SCALE 
I DSH* 0 
I NT = 1 0 

TEHP = LAND< I MAGE ( 1 I/0001000C3) 

SCALE«LAND( IMAGE! 1 )>77760000B) 
IF!TEMP.NE*000C0C00B) IDSH=1 
RETURN 
END 



LOGICAL FUNCTION CHANGE ( Z/ I SWI TCH ) 
INTEGER Z 
CHANGE B • FALSE • 

N 0 = 1 6 " Z 

ITEMP=LCRS( ISWITCH/NO) 

IF(LAND( ITEMP/00C00001B) .E3*0> GO TO 50 
CHANGE = • TRUE • 

50 RETURN 

end 
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E9M 032C02 ENABLE AGT2 

LOB =0 

LDA * JBYSTK+3 DEV N0. 

SKA I08FL L99P UNTIL 1/9 BUSY FLAG N0T BUSY 
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LIBRARY PROGRAM REPORT 



ROUTINE NAME: 


JOYSTK 


ROUTINE TYPE: 


Fortran callable subroutine 


PURPOSE: 


To obtain the x, y and z values of the joystick 
attached to the AGT-10. 


SOURCE LANGUAGE: 


Metasymbol 


AUTHOR: 


Ralph H. Stowell , Jr. 


CALLING SEQUENCE: 


CALL (IDEV, JOY, AJOY, IER) 

Where; IDEV = AGT being utilized. 

JOY = An integer array of dimension (3) in 
which the digitized values of the 
joystick are stored. 

AJOY = A real array of dimension (3) in which 
the equivalent floating point values 
are stored after being transformed in 
the JOYSTK routine. 

IER = Error flag. 


DISCUSSION: 


This subroutine is used to obtain the digitized 
values of the joystick at the AGT and through the 
use of another library subroutine, XFORM, transform 
the values into an equivalent floating point number. 
The user may then utilize these values to either 
control the flow of a fortran program or to modify 
a graphics block sent over from the 9300. Once the 
call to JOYSTK has been made the above may be 
accomplished similar to the examples shown below. 

EX. If (JOY ( 1 ) .GT. .25) stop 

DX = JOY (1 ) 



NOTE: The x, y, and z values of the joystick, map to J0Y(1), (2) and 

(3) respectively. 
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EBM 032002 ENABLE AGT2 

LDB =0 

LDA * VCD+3 DEV NB • 

SKA I 9BFL L99P UNTIL 1/3 N0T BUSY 
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LIBRARY PROGRAM REPORT 



ROUTINE NAME: 
ROUTINE TYPE: 
PURPOSE: 

SOURCE LANGUAGE: 
AUTHOR: 

CALLING SEQUENCE: 



DISCUSSION: 



VCD 

Fortran callable subroutine 

To obtain the settings of the variable control dials 
attached to the AGT-10. 

Metasymbol 

Ralph H. Stowell, Jr. 



CALL VCD ( IDEV, IDIAL, DIAL, IER) 

Where; I DEV = AGT being utilized 

IDIAL = An integer array of dimension (6) in 
which the digitized values of the 
variable control dials are stored. 

DIAL = A real array of dimension (6) in which 
the equivalent floating point values 
are stored after being transformed in 
the VCD routine. 

IER = Error flag. 

This subroutine is used to obtain the digitized values 
of the variable control dials at the AGT and through 
the use of another library subroutine, XFORM, trans- 
form the values into an equivalent floating point 
number. The user may then use these values to either 
control the program flow of a Fortran program or 
then modify a graphics block sent over from the 9300. 
Once the call to VCD has been made, the above may be 
accomplished similar to the examples shown below. 

EX. I F ( DIAL (l).GT.l.O) Stop 

or 

DX = DIAL ( 2 ) 
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NOTE: 



The control dials are numbered vertically not horizontally as 
would be expected. 
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SWDER LDA = 1 BAD DEVICE NB. 

SWER STA *SWI TCH+5 

BRR SWITCH RETURN 

SWMER LDA =10 MEMORY NOT ACCESSIBLE BY INTERFACE 



BRU SWER ERROR EXIT 

SWSWB PZE 0 ALLOCATE SWQ'S 

PZE 0 

PZE 0 

END 
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LIBRARY PROGRAM REPORT 



ROUTINE NAME: 
ROUTINE TYPE: 
PURPOSE: 

SOURCE LANGUAGE: 
AUTHOR: 

CALLING SEQUENCE: 



DISCUSSION: 



SWITCH 

Fortran callable subroutine 

To obtain the on/off value for each of the 16 function 
switches attached to the AGT/10. 

Metasymbol 

Ralph H. Stowell , Jr. 



CALL SWITCH (IDEV, ISWITCH, IER) 

Where; IDEV = AGT being utilized. 

ISWITCH = Location in which the returned 

values for the switches are returned. 

IER = Error flag. 

This subroutine is used to obtain the on/off values 
of the function switches, which may then be used to 
control the program flow, or any other task the 
user desires. Once the call to switch has been made 
another routine change must be called to test the 
values. 

EX. Call switch (IDEV, ISWITCH, IER) 

IF (CHANGE (3, ISWITCH)) GO to- 
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LIBRARY PROGRAM REPORT 



ROUTINE NAME: 
ROUTINE TYPE: 
PURPOSE: 

SOURCE LANGUAGE: 

AUTHOR: 

DISCUSSION: 



XFORM 

Metasymbol callable routine 

To transform signed fractional values obtained from 
the VCD and JOYSTK routines to their equivalent 
floating point values. 

Metasymbol 

Ralph H. Stowell , Jr. 

While XFORM is normally called from within VCD or 
JOYSTK in order to obtain the floating point value 
of the digitized readings returned from the AGT-10, 
it could just as well be called in a Fortran program 
to shift an integer value to floating point value. To 
do this the following calling sequence would have to 
be used. 

CALL XFORM (INT, REAL, NO) 

Where; INT = Integer involved. 

REAL = REAL variable, the value is to be 
stored in. 

NO = Total number of words to be trans- 
formed -1 . 
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